SAVE GRAPHICS SCREEN

Description:
This command will save a specific portion of the graphics screen in
similar fashion to Clipper's SAVE and RESTORE SCREEN commands.  There
are certain limitations to dGE's ability to save and restore screen
regions so read carefully about SNAPCOPY() before using this feature.
The maximum number of screen saves that are possible is limited by
default to 20, however, this can be changed by modifying the pre-
processor constant MaxScreens in this file.

Syntax:
SAVE GRAPHICS SCREEN <label> FROM <Pos1_a>,<Pos1_b> TO <Pos2_a>,<Pos2_b>

Arguments:
<label> is a name tag that identifies the screen for later recall.
<Pos1_a> is the upper left row screen coordinate of the box.
<Pos1_b> is the upper left column screen coordinate of the box.
<Pos2_a> is the lower right row screen coordinate of the box.
<Pos2_b> is the lower right column screen coordinate of the box.

Example:
SAVE GRAPHICS SCREEN "scr_one" ;          // save screen ONE
   FROM <Pos1_a>,<Pos1_b> ;
   TO <Pos2_a>,<Pos2_b>

         Purpose: Save an area of the graphics screen
 Mapped Function: __SaveGScreen() contained in GLLIBR.PRG.
   dGE functions: snapcopy()
   Other GL UDFs: None.
System variables: _screens_[]
System constants: MaxScreens

See Also:
RESTORE GRAPHICS SCREEN